home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 25 / Cream of the Crop 25.iso / bbs / eumal704.zip / EUMAIL.DOC < prev    next >
Text File  |  1997-04-28  |  33KB  |  660 lines

  1. EUMAIL.DOC                             1                           Apr 28, 1997
  2.  
  3. The EUMAIL.EXE program does some summarizing for  the  Eudora  Internet  e-mail
  4. program.
  5.  
  6. What is Eudora?  Eudora is an excellent Internet e-mail program.  It's put  out
  7. by QUALCOMM Incorporated in San Diego California.  The latest version of Eudora
  8. Light   can    be    found    on    ftp.qualcomm.com,    in    the    directory
  9. quest/windows/eudora/1.5.  The Windows freeware user manual can also  be  found
  10. on ftp.qualcomm.com, in the directory quest/windows/eudora/documentation.
  11.  
  12. EUMAIL, on the other hand, is a freeware utility which reads Eudora's files and
  13. provides the following benefits:
  14.  
  15.   * Allows you to save your Eudora nickname file  (containing  individuals  and
  16.     groups with the corresponding e-mail addresses) as a DOS text file which is
  17.     useful for searching and such.  (Have you ever tried to find out where  all
  18.     you have someone's e-mail address referenced in your nickname file?)
  19.   * Presents a summary of how many messages you  have  in  each  of  your  mail
  20.     folders, including their date range and their total  size  in  bytes,  plus
  21.     what share of total mailbox bytes this particular folder accounts for.
  22.   * Allows you to dump all (or a subset of your mailboxes) as  straight  ASCII-
  23.     text files.  There will be one text file per mailbox, prefaced by  a  table
  24.     of contents for all messages in that mailbox.
  25.   * Allows you to write out just the table of contents as an ASCII text file.
  26.   * Allows you to write each individual message as  an  incremented  file  name
  27.     (TRASH.001, TRASH.002, etc).
  28.   * Allows you to process all mailboxes or all mailboxes whose names begin with
  29.     a certain string.
  30.   * The date format shown is based on your country setting as detected by DOS.
  31.   * Pressing escape stops the program early.
  32.  
  33.  
  34.  
  35. EUMAIL.DOC                             2                           Apr 28, 1997
  36.  
  37. Quickie instructions:
  38.  
  39. Okay!  You hate to read.  I know that.  And there aren't any cute  pictures  in
  40. this documentation and, like everything I write, it's way too long to keep your
  41. attention for long.  So, let's bottom line it; what's the quickest way  to  use
  42. this program without learning any of the options?
  43.  
  44. Make sure you've extracted EUMAIL.EXE from the EUMALymm.ZIP file.  Run it.
  45.  
  46. The first time it's run, EUMAIL will try to find your main Eudora subdirectory.
  47. It will scan drive C, then D, etc looking for  the  EUDORA.EXE  (or  the  older
  48. WEUDORA.EXE) file.  Once it finds it, it will tell you where it found the  file
  49. and ask if you want to save this location in an  INI  file.   If  you  say  "Y"
  50. (yes), it will create a EUMAIL.INI file for you and store the  location  there.
  51. The next time you run EUMAIL, it will not need to scan for the subdirectory.
  52.  
  53. Then it will do a bunch of status messages and create two text  files  in  your
  54. Windows' TEMP subdirectory (typically C:\TEMP).  It will tell you the two files
  55. it creates but they default to EUMAIL.TXT and EUMAIL.BOX.  Use a file viewer or
  56. the Windows NotePad program to view these files.  They are described below.
  57.  
  58. Type in "EUMAIL /?" and try out some of the  other  parameters.   If  you  find
  59. yourself consistently  overriding  some  of  them,  they  can  be  saved  in  a
  60. EUMAIL.INI file.  Read the BRUCEINI.DOC file for information on how to do this.
  61.  
  62.  
  63.  
  64. EUMAIL.DOC                             3                           Apr 28, 1997
  65.  
  66. EUMAIL.TXT:  The e-mail data base:
  67.  
  68. EUMAIL creates a dump of your e-mail data base.  By default, this file will  be
  69. called EUMAIL.TXT (override with /NL=filename parameter) and will be stored  in
  70. your Windows' TEMP subdirectory (e.g.  C:\TEMP).  This  file  includes  all  of
  71. your nicknames and comments (the use of comments is heavily recommended).  This
  72. is an ideal file to use the DOS FIND  command  (or  the  Wayne  Software  BFIND
  73. command) to search through.  A sample of the format:
  74.  
  75. BanBruce      : Bruce Guthrie            <bguthrie@doc.gov>
  76. BanForrest    : Forrest Williams         <fwilliams@doc.gov>
  77. BanJoe        : Joe Correia              jcorreia@doc.gov
  78. BanTravis     : Travis Mayo              <tmayo@doc.gov>
  79. WS_READ       : Billy Rudock             <billy_rudock@notes.seagate.com>
  80.            [2]: Les Ferch                <ferch@cce.ubc.ca>
  81.            [3]: Martin Mossakowski       <mossako@asterix.uni-muenster.de>
  82.            [4]: Tony Vincent             <tonyvinc@iconz.co.nz>
  83. XList         > requests: majordomo@chaos.taylored.com
  84. XList         > msg: SUBSCRIBE X-FILES
  85. XList         > msg: SUBSCRIBE X-FILES-DIGEST
  86. XList         > msg: UNSUBSCRIBE X-FILES
  87. XList         : x-files@chaos.taylored.com
  88.  
  89. The fields in the file are:
  90.   * The nickname you've defined for this user
  91.   * The actual name (if any) of that user
  92.   * The e-mail address for that user
  93.  
  94. Comments are indicated with ">" entries  and  they  appear  before  the  actual
  95. entry.
  96.  
  97. Nicknames which define multiple users are sorted by actual  name  and  then  by
  98. e-mail address.  Typically, as is shown above, only the first instance  of  the
  99. nickname is shown with all of the individual contacts shown with  item  counts.
  100. Alternatively, you can use the /REPEAT  option  and  the  nickname  label  will
  101. repeat for each item.  The latter option is useful when you are using the  FIND
  102. or BFIND command to searchfor all members of a particular group.
  103.  
  104.  
  105.  
  106. EUMAIL.DOC                             4                           Apr 28, 1997
  107.  
  108. EUMAIL.BOX:  The summary of your Eudora mailboxes and folders:
  109.  
  110. EUMAIL creates a summary of all the mailboxes and folders you've  created.   By
  111. default, this file  will  be  called  EUMAIL.BOX  (override  with  /NS=filename
  112. parameter) and  will  be  stored  in  your  Windows'  TEMP  subdirectory  (e.g.
  113. C:\TEMP).  This file shows, for each of your boxes, the following  information:
  114. the number of messages, their date range, the size of the  box  in  bytes,  and
  115. what percent of total bytes consumed each box accounts for.  A fairly  complete
  116. dump of what mine looked like when I ran it:
  117.  
  118. C:\TEMP\PHONMAIL.OUT generated 10-18-1996 00:54:08 by EUMAIL.EXE
  119.  
  120. Box/folder name    msgs % of   earliest -> newest         bytes  % of
  121.                         msgs                                    bytes
  122.  
  123. In                   34   1%   05-21-96 -> 10-16-96     324,042    2%
  124. Trash               346   9%   11-15-94 -> 10-17-96   1,156,646    7%
  125. Out                 256   6%   10-14-96 -> 10-16-96     463,945    3%
  126.   ... (portion deleted to make it fit on the page) ...
  127. Wayne               187   5%   04-07-96 -> 10-16-96     426,159    3%
  128. X-Files              28   1%   04-07-96 -> 10-16-96     130,698    1%
  129. Humans
  130.   Arlene            343   9%   08-12-96 -> 10-16-96   1,157,929    7%
  131.   Family             46   1%   01-19-96 -> 10-07-96      67,100    0%
  132.   Munchkyn           29   1%   12-15-95 -> 10-15-96      47,420    0%
  133.   Webman             50   1%   02-02-96 -> 10-15-96      99,420    1%
  134.     4 boxes         468  12%   12-15-95 -> 10-16-96   1,371,869    9%
  135. Humor
  136.   __Progress        139   3%   04-28-96 -> 10-15-96     381,048    2%
  137.   _Cartoons          67   2%   04-28-96 -> 10-05-96     437,440    3%
  138.   _Comedians         64   2%   05-01-96 -> 10-08-96     357,953    2%
  139.   ... (portion deleted to make it fit on the page) ...
  140.   _Songs/Lyrics       6   0%   05-11-96 -> 08-13-96      15,852    0%
  141.   _TV/Movies          7   0%   05-20-96 -> 10-05-96      54,606    0%
  142.     8 boxes         830  21%   02-06-96 -> 10-15-96   2,876,881   18%
  143. Keep
  144.   1993                3   0%   10-22-93 -> 10-24-93       7,907    0%
  145.   1994                3   0%   05-18-94 -> 12-11-94      20,506    0%
  146.   1995               27   1%   01-05-95 -> 12-29-95      78,193    1%
  147.   1996               85   2%   01-02-96 -> 02-28-96     226,929    1%
  148.   0_Hold             87   2%   10-28-95 -> 09-16-96     193,348    1%
  149.     5 boxes         205   5%   10-22-93 -> 09-16-96     526,883    3%
  150. Misc
  151.   Misc               19   0%   03-16-96 -> 10-10-96      46,542    0%
  152.   NMAA                6   0%   09-28-95 -> 09-28-96      23,172    0%
  153.   Resends            41   1%   09-01-96 -> 10-01-96      10,378    0%
  154.   Websites           16   0%   02-20-96 -> 07-19-96      33,831    0%
  155.   Work                1   0%   04-08-96 -> 04-08-96      10,867    0%
  156.     5 boxes          83   2%   09-28-95 -> 10-10-96     124,790    1%
  157. Out_Prev
  158.   Wk39              380   9%   09-23-96 -> 09-29-96   1,168,188    7%
  159.   Wk40              384  10%   09-30-96 -> 10-06-96     810,029    5%
  160.   Wk41              244   6%   10-07-96 -> 10-13-96     505,446    3%
  161.     3 boxes       1,008  25%   09-23-96 -> 10-13-96   2,483,663   16%
  162.  
  163.   37 boxes        4,023 100%   11-15-94 -> 10-17-96  15,588,849  100%
  164.  
  165.  
  166. EUMAIL.DOC                             5                           Apr 28, 1997
  167.  
  168. The program, by default, will automatically display information  about  "large"
  169. boxes based on a combination of three criteria.   Lines  above  will  be  shown
  170. on-screen for any box which exceeds any of the three criteria.  The three are:
  171.  
  172.   * The total number of messages in the box (/n parameter)
  173.   * The total number of (thousand) bytes in the box (/nK parameter)
  174.   * The percentage of total bytes that that box accounts for (/n% parameter)
  175.  
  176. The defaults are /100, /100K, and /5%.
  177.  
  178. If you'd like to turn off the on-screen display entirely, you can  specify  the
  179. /Q parameter.  If you'd like the criteria to be based on one  or  two  criteria
  180. only, specify an unusually large value for the other parameter(s) (for example,
  181. /30000K).
  182.  
  183. Using an INI file for the criteria (see later) is always an option.
  184.  
  185.  
  186. Header formats:
  187.  
  188. When you request either /DUMP or /HEADERS, the program  will  generate  headers
  189. which describe what messages are in your  file.   The  order  of  the  messages
  190. corresponds to the order shown in Eudora.  Message sizes are shown in lines  if
  191. /DUMP is used, and in thousand bytes if /HEADER is used.  The exact  format  of
  192. the headers depends on your value for the  /FORMAT=n  parameter.   The  various
  193. formats are:
  194.  
  195. /FORMAT=1:  Show one line per mail message.  This format closely  matches  that
  196.             shown in Eudora itself.  This is initially the default for EUMAIL.
  197. /FORMAT=2:  Show two or more lines per message.  The subject gets a line all to
  198.             itself.  You may get three lines for some messages if the length of
  199.             the "Sender" field is long.
  200. /FORMAT=3:  Show one line per mail message.  This format shows just the message
  201.             size and subject line; this is useful when you're using  Eudora  to
  202.             catalog messages and such and don't really care when they were sent
  203.             or from whom.
  204.  
  205.  
  206. EUMAIL.DOC                             6                           Apr 28, 1997
  207.  
  208. Examples of each format are shown below (remember, the size of the  message  is
  209. measured in lines if /DUMP is used, bytes if /HEADER is used):
  210.  
  211. Contents:                       (using /FORMAT=1)
  212.  
  213.   1 Bruce Guthrie    04:31 PM 3/26/96   2 Round robin time
  214.   2 Bruce Guthrie    11:44 AM 4/7/96    1 RE: FORB data update
  215.   3 Olumoya - Pamela 07:49 PM 4/7/96   14 Posting Guidelines for X-Files-Fanfic
  216.   4 Heather and Eric 07:29 PM 4/19/96   4 re: Vancouver locations for x-filese
  217.  
  218. Contents:                       (using /FORMAT=2)
  219.  
  220.   1 Bruce Guthrie                            04:31 PM 3/26/96      2K
  221.     Round robin time
  222.   2 Bruce Guthrie                            11:44 AM 4/7/96       1K
  223.     RE: FORB data update
  224.   3 Olumoya - Pamela                         07:49 PM 4/7/96      14K
  225.     Posting Guidelines for X-Files-Fanfic
  226.   4 Heather and Eric                         07:29 PM 4/19/96      4K
  227.     re: Vancouver locations for x-filese
  228.  
  229. Contents:                       (using /FORMAT=3)
  230.  
  231.   1     2K   Round robin time
  232.   2     1K   RE: FORB data update
  233.   3    14K   Posting Guidelines for X-Files-Fanfic
  234.   4     4K   re: Vancouver locations for x-filese
  235.  
  236.  
  237. ASCII dumps:
  238.  
  239. The EUMAIL program will dump the contents of all of your e-mail boxes  for  you
  240. if you'd like.  (Optionally, you can specify that it only dump mailboxes  whose
  241. names begin with a certain character string.) In so doing, it creates  a  table
  242. of contents and divided each article with a page eject for you.  The format for
  243. this table of contents is discussed above.
  244.  
  245. The ASCII message dump is requested with the /DUMP parameter.  A separate  dump
  246. file  (with  an  extension  of  *.DMP)  will  be  created  for  each   mailbox.
  247. Alternatively, you can request that a separate text file be  created  for  each
  248. message, in which case the file extensions will  have  incremented  names  (for
  249. example, TRASH.001, TRASH.002, etc; after 999 messages, they will start  to  be
  250. named TRASH.A00 etc).
  251.  
  252. All dump files are left in the same subdirectories you mail is in.   Note  that
  253. Eudora places each mail folder in a subdirectory off the current level.
  254.  
  255. You may want to PKZIP one or more of the *.DMP files and then move them out  of
  256. your Eudora subdirectories, perhaps storing  them  on  a  floppy  diskette  for
  257. purposes of retaining them.  As long as you are reasonably sure  you  will  not
  258. want to be doing responses or something in Eudora, you can delete the  messages
  259. from the mailboxes you save this way.
  260.  
  261. Personally, I save all of my outgoing messages for some reason.  I then save an
  262. ASCII version of what I sent, compress it, and then delete them en masse.
  263.  
  264. If you'd like, you can get just the table of contents for the messages and skip
  265. the actual dump of the messages themselves.  This can be achieved by using  the
  266.  
  267. EUMAIL.DOC                             7                           Apr 28, 1997
  268.  
  269. /HEADER option.
  270.  
  271. If you later decide you want to kill off all of the *.DMP files,  pass  in  the
  272. parameter /KILLDUMP and it will take care of them for you.
  273.  
  274.  
  275. Specifying parameters:
  276.  
  277. Parameters for this program can be set in the following ways.  The last setting
  278. encountered always wins:
  279.   - Read from an *.INI file (see BRUCEINI.DOC file),
  280.   - Through the use of an environmental variable (SET EUMAIL=whatever), or
  281.   - From the command line (see "Syntax" below)
  282.  
  283.  
  284.  
  285. EUMAIL.DOC                             8                           Apr 28, 1997
  286.  
  287. Syntax:
  288.  
  289.     EUMAIL [ /Eeudora_sub ] [ /Ooutput_sub ]
  290.       [ /NL=filename | /-NL ] [ /REPEAT ]
  291.       [ /NS=filename | /-NS ] [ /n ] [ /nK ] [ /n% ] [ /SHOWEXT ] [ /Q ]
  292.       [ /DUMP | /HEADERS | /SPLIT | /KILLDUMP ] [ domain ] [ /FORMAT=n ]
  293.       [ /HEAD=xxxx ] [ /WIDTH=n ] [ /Tpath ]
  294.       [ /MONO ] [ /Iinitfile | /-I ] [ /-ENV ] [ /? ]
  295.  
  296. where:
  297.  
  298. "/Eeudora_sub" is the location where you installed Eudora.  There is no default
  299. for this parameter.  If no location is provided, the program will scan for  the
  300. EUDORA.EXE file on all of your available hard disks until it finds it. It  will
  301. then allow you to save this information in a EUMAIL.INI file so it doesn't need
  302. to scan again in subsequent times.  (INI files are explained in BRUCEINI.DOC.)
  303.  
  304. "/Ooutput_sub" is the subdirectory in which you want to write  the  two  output
  305. files.  This subdirectory must exist already.  It defaults to whatever you have
  306. "SET TEMP=subdir" set in your CONFIG.SYS file.  Again, the use of a  EUMAIL.INI
  307. file is heavily recommended (see BRUCEINI.DOC).
  308.  
  309. "/NL=filename" specifies the filename that the nickname listing is to go to. If
  310. no drive/path information is specified, this  file  will  be  written  to  your
  311. /Ooutput_sub specification.  Otherwise, the name will override the /Ooutput_sub
  312. specification.  Saying "/-NL" or "/NL=" without  any  filename  indicator  will
  313. suppress  the  creation  of  the  nicknames  file  altogether.    Defaults   to
  314. /NL=EUMAIL.TXT.
  315.  
  316. "/-NL" suppresses the creation of the nickname file entirely.
  317.  
  318. "/REPEAT" says to repeat the names of the nicknames when  they're  listed.   It
  319. looks better if you don't repeat them but if you use something like FIND on the
  320. file, you might want to have them repeating.  Initially defaults to /-REPEAT.
  321.  
  322. "/-REPEAT" is the opposite of "/REPEAT".  The name of the nickname only appears
  323. once even if it contains five e-mail addresses.  There very  first  example  in
  324. this documentation shows the output  with  /-REPEAT.   This  is  initially  the
  325. default.
  326.  
  327. "/NS=filename" specifies the filename that the mailbox/folder  summary  listing
  328. is to go to.  If no drive/path information is  specified,  this  file  will  be
  329. written to your /Ooutput_sub specification.  Otherwise, the name will  override
  330. the /Ooutput_sub specification.  Saying "/-NS" or "/NS=" without  any  filename
  331. indicator will suppress the listing of the  summary  altogether.   Defaults  to
  332. /NS=EUMAIL.BOX.
  333.  
  334. "/-NS" suppresses the creation of the mailbox summary file entirely.
  335.  
  336.  
  337. EUMAIL.DOC                             9                           Apr 28, 1997
  338.  
  339. "/n" specifies that any mailbox with more than "n" entries is to  be  indicated
  340. on the screen when the program runs.  The test for this is  done  independently
  341. of the tests for the number or entries or the absolute filesize test;  any  box
  342. with more than /n message or with a filesize bigger than /nK or a share of more
  343. than /n% will be displayed unless /Q is specified.  Defaults to /100.
  344.  
  345. "/nK" specifies that any mailbox with more than "n" thousand (K) bytes is to be
  346. indicated on the screen when the program runs.   The  test  for  this  is  done
  347. independently of the tests for the number or entries or the  absolute  filesize
  348. test; any box with more than /n message or with a filesize bigger than /nK or a
  349. share of more than /n% will be displayed unless /Q is specified.   Defaults  to
  350. /100K.
  351.  
  352. "/n%" specifies that any mailbox with more than "n" percentage (%) of the total
  353. bytes used by all stored mail is to be shown on the  screen  when  the  program
  354. runs.  The test for this is done independently of the tests for the  number  or
  355. entries or the absolute filesize test; any box with more  than  /n  message  or
  356. with a filesize bigger than /nK or a share of more than /n% will  be  displayed
  357. unless /Q is specified.  Defaults to /5%.
  358.  
  359. "/SHOWEXT" shows the message dates as they appear in the Eudora  displays.   At
  360. times, this is confusing since the dates are actually sorted by their  internal
  361. date format.  In addition, if you've changed external date formats or you  have
  362. one setting in Windows and another in DOS, EUMAIL will blow up with an  invalid
  363. function error.  Thus it's safer to use /SHOWINT which is the initial  default.
  364. If you do decide to use this option,  be  sure  to  read  the  "COUNTRY  Notes"
  365. section below.
  366.  
  367.      NOTE ABOUT "INVALID FUNCTION CALL" ERROR MESSAGES:  If are  using  the
  368.      /SHOWEXT setting, you may encounter errors in using this program.  The
  369.      main reason for this is either (a) you've changed  your  default  date
  370.      format since you started receiving  mail  using  Eudora  or  (b)  your
  371.      Windows country setting (which is what Eudora uses) is different  from
  372.      what your DOS setting (which is what EUMAIL uses) is.   If  either  of
  373.      these are the case, you will  probably  get  "invalid  function  call"
  374.      errors.  See the section  on  "Country  Notes"  at  the  end  of  this
  375.      documentation for  information  on  how  to  set  the  value  in  your
  376.      CONFIG.SYS file. In most cases, simply do not use the /SHOWEXT  option
  377.      and you'll be fine. However, in dire circumstances, you can rename the
  378.      *.TOC file as *.BAK for any mailbox that gives you trouble and  Eudora
  379.      will automatically try to recreate  it  for  you.   This  is  not,  of
  380.      course, recommended since it may cause problems.
  381.  
  382. "/SHOWINT" shows the message dates in their real internal date format.  This is
  383. initially the default.
  384.  
  385. "/Q" says that no individual mailboxes are to be indicated on the  screen  when
  386. the program runs.  This ignores any /n, /nK, or /n% settings.
  387.  
  388.  
  389. EUMAIL.DOC                             10                          Apr 28, 1997
  390.  
  391. "/DUMP" says to dump the contents of the mailboxes  out  as  plain  ASCII  text
  392. documents.  The program generates one text file for each mailbox.  The  program
  393. will also add a table of contents in front of each  dump  for  you.   The  dump
  394. files will be the name of the folder with a *.DMP file  extension.   Note  that
  395. the messages will appear in the order they show up when you view  them  on  the
  396. screen and you may  want  to  re-sort  them  all  first.   See  the  /HEAD=xxxx
  397. parameter too.  Defaults to /-DUMP (don't create the dump files).
  398.  
  399. "/HEADERS" says to write out the message headers only, not the actual messages.
  400. See the /FORMAT=n parameter below.  The header files will be the  name  of  the
  401. folder with a *.DMP file extension.
  402.  
  403. "/SPLIT" takes each messages and dumps it as a individual text file.  The files
  404. will be named as the DOS name of the mailbox with numeric extensions  beginning
  405. with 001 (for example, TRASH.001, TRASH.002, etc).
  406.  
  407. "/KILLDUMP" deletes any  *.DMP  files  it  finds.   Also  deletes  any  of  the
  408. /SPLIT-produced files (for example, TRASH.001) that it finds.  This is used  if
  409. you later decide you don't want any of the *.DMP  files  around  or  if  you've
  410. already moved out the ones you need and you no longer want  the  rest  of  them
  411. around.  (Note:  /KILLDUMP will not delete any *.DMP or *.xxx files for you  if
  412. you've deleted the mailbox itself.)
  413.  
  414. "domain" restricts /DUMP and /HEADERS processing  to  only  those  files  whose
  415. names begin with a particular character string.  As an  example,  if  you  just
  416. want to dump the "Out" mailbox, pass in "OUT" as in "EUMAIL /DUMP  OUT".   Note
  417. that this will also dump other mailboxes whose names begin with "OUT" which may
  418. be useful to you.  If your mailbox name includes a space, you can specify  this
  419. by replacing the space with an underscore (for  example,  "Joke  List"  can  be
  420. entered as "JOKE_LIST").  By default, all mailboxes are dumped if any are.
  421.  
  422. "/FORMAT=n" specifies what the headers are to look like in a /DUMP or  /HEADERS
  423. request.  Basically, /FORMAT=1 creates the headers as one line per message,  in
  424. a manner similar to the way that Eudora itself displays the headers.  /FORMAT=2
  425. expands the header information to being two lines.   /FORMAT=3  is  similar  to
  426. /FORMAT=1 but the author and date/time are  dropped.   See  the  discussion  on
  427. "Header formats" above for examples of the each type.   Initially  defaults  to
  428. /FORMAT=1.
  429.  
  430. "/HEAD=xxxx" specifies that instead of seeing all of the message  headers  when
  431. you dump the messages, it only shows specific lines from  the  header  section.
  432. You can use any combination of the following characters:
  433.     T = "To:"
  434.     F = "From:"
  435.     S = "Subject:"
  436.     D = "Date:"
  437. So "/HEAD=S" will give you just the Subject line.  Normally, you'll get all  of
  438. the headers.
  439.  
  440. "/WIDTH=n" specifies that the lines in the EUMAIL.BOX file  should  not  exceed
  441. n-characters.  If the name  of  a  mailbox  exceeds  26  characters  (including
  442. indentation), the output would be wider than 80 characters.  If  this  is  okay
  443. with you, feel free to override the specification.   The  setting  is  used  to
  444. shrink columns, not expand them, so if you have short  mailbox  names  and  you
  445. specify /WIDTH=200,  the  program  will  still  give  you  a  compact  listing.
  446. Initially defaults to /WIDTH=80.
  447.  
  448.  
  449. EUMAIL.DOC                             11                          Apr 28, 1997
  450.  
  451. "/Tpath" specifies where to write the temporary files that the  routine  needs.
  452. ISAM data bases are used to store and sort the file names.  ISAM  files  cannot
  453. be created reliably on certain  types  of  drives.   Examples  are  "/TC:"  and
  454. "/TC:\TEMP".  If  not  specified,  the  routine  writes  to  the  following  in
  455. sequence:
  456.  
  457.   - the value of any TEMP, then TMP, environmental variable
  458.   - C:\TEMP
  459.   - C:\
  460.  
  461. "/MONO" (or "/-COLOR") does not  try  to  override  screen  colors.   Initially
  462. defaults to "/COLOR".
  463.  
  464. "/COLOR" (or  "/-MONO")  allows  screen  colors  to  be  overridden.   This  is
  465. initially the default.
  466.  
  467. "/Iinitfile" says to read an initialization file with the file name "initfile".
  468. The file specification *must* contain a period.  Initfiles are described in the
  469. BRUCEINI.DOC file.  Initially defaults to "/IEUMAIL.INI".
  470.  
  471. "/INULL" says to skip loading the initialization file.
  472.  
  473. "/ENV" says to look for %var% occurrences  in  the  command  line  and  try  to
  474. resolve any apparent environmental variable references.  See  BRUCEINI.DOC  for
  475. more information.  This is initially the default.
  476.  
  477. "/-ENV" says to skip resolving apparent %var% occurrences in the command  line.
  478. Initially defaults to "/ENV".
  479.  
  480. "/?" or "/HELP" or "HELP" shows you the syntax for the command.
  481.  
  482.  
  483. Return codes:
  484.  
  485. EUMAIL returns the following ERRORLEVEL codes:
  486.  
  487.         0 = no problems
  488.       250 = operation aborted by pressing Escape
  489.       252 = internal restriction breached
  490.       253 = no files found
  491.       254 = could not find a decent temporary output subdirectory
  492.       255 = syntax problems, or /? requested
  493.  
  494.  
  495.  
  496. EUMAIL.DOC                             12                          Apr 28, 1997
  497.  
  498. COUNTRY Notes:
  499.  
  500.    If your DOS COUNTRY setting (which, if not present, defaults to the US  date
  501.    format of mm-dd-yyyy) is different from the  setting  you  have  in  Windows
  502.    (which is how the dates are showing up in  Eudora),  you  may  get  "illegal
  503.    function call" errors.
  504.  
  505.    The following section tells you how to modify the settings.   It's  modified
  506.    slightly but is copied from the DOS 6.2 HELP command.
  507.  
  508.    The basic format for the COUNTRY command is:
  509.  
  510.            COUNTRY=xxx[,[yyy][,[drive:][path]filename]]
  511.  
  512.    where:
  513.  
  514.            xxx = the country code (see below)
  515.            yyy = the character set for the country (used for setting keyboard
  516.                  types; we'll ignore this one)
  517.            [drive:][path]filename = where the COUNTRY.SYS file is
  518.  
  519.    For example:
  520.  
  521.             COUNTRY=033,,c:\dos\country.sys
  522.  
  523.    Says to use  France's  country  code  for  date,  skips  the  character  set
  524.    entirely, and says COUNTRY.SYS is c:\dos\country.sys
  525.  
  526.  
  527. Changing default settings:
  528.  
  529.    MS-DOS uses the United States as the  default  setting.   You  can  use  the
  530.    COUNTRY command in your CONFIG.SYS file to change the setting.
  531.  
  532.    If you do  not  specify  the  location  and  name  of  the  file  containing
  533.    country-specific information, MS-DOS tries to find the COUNTRY.SYS  file  in
  534.    the root directory of your startup drive.
  535.  
  536.  
  537.  
  538. EUMAIL.DOC                             13                          Apr 28, 1997
  539.  
  540. Specifying supported languages:
  541.  
  542.    The following table lists each country or language supported by MS-DOS.  The
  543.    table also lists the character sets you can use with each country code.  For
  544.    example, if you use country code 003, you can use only character set 437  or
  545.    850 for the yyy parameter.  The first of the two character sets  listed  for
  546.    each country or language is its default character set.
  547.  
  548.            Country or language    Country       Character sets
  549.                                                 code
  550.  
  551.  
  552.            Belgium                032           850, 437
  553.            Brazil                 055           850, 437
  554.            Canadian-French        002           863, 850
  555.            Croatia                038           852, 850
  556.            Czech Republic         042           852, 850
  557.            Denmark                045           850, 865
  558.            Finland                358           850, 437
  559.            France                 033           850, 437
  560.            Germany                049           850, 437
  561.            Hungary                036           852, 850
  562.            International English  061           437, 850
  563.            Italy                  039           850, 437
  564.            Latin America          003           850, 437
  565.            Netherlands            031           850, 437
  566.            Norway                 047           850, 865
  567.            Poland                 048           852, 850
  568.            Portugal               351           850, 860
  569.            Serbia/Yugoslavia      038           852, 850
  570.            Slovakia               042           852, 850
  571.            Slovenia               038           852, 850
  572.            Spain                  034           850, 437
  573.            Sweden                 046           437, 850
  574.            Switzerland            041           850, 437
  575.            United Kingdom         044           437, 850
  576.            United States          001           437, 850
  577.  
  578.    Character sets for the following countries or languages are  also  available
  579.    with special versions of MS-DOS:  Arabic,  Israel,  Japan,  Korea,  People's
  580.    Republic of China, and Taiwan.
  581.  
  582.  
  583.  
  584. EUMAIL.DOC                             14                          Apr 28, 1997
  585.  
  586. Specifying international time and date formats:
  587.  
  588.    The country code specifies the time and date formats used by  the  following
  589.    MS-DOS commands:  BACKUP, DATE, RESTORE, and TIME.
  590.  
  591.    The following table lists the date and time formats related to each  country
  592.    code.  For each country code, the "Date  format"  column  shows  how  MS-DOS
  593.    displays January 3, 1993, and the "Time  format"  column  shows  how  MS-DOS
  594.    displays 5:35 P.M.  (with 0 seconds and 0 hundredths of a second).
  595.  
  596.            Country or language    Country       Date code    Time format
  597.  
  598.            Belgium                032           23/01/1993   17:35:00
  599.            Brazil                 055           23/01/1993   17:35:00
  600.            Canadian-French        002           1993-01-23   17:35:00
  601.            Czechoslovakia         042           1993-01-23   17:35:00
  602.            Denmark                045           23-01-1993   17.35.00
  603.            Finland                358           23.01.1993   17.35.00
  604.            France                 033           23.01.1993   17:35:00
  605.            Germany                049           23.01.1993   17:35:00
  606.            Hungary                036           1993-01-23   17:35:00
  607.            International English  061           23-01-1993   5:35:00.00p
  608.            Italy                  039           23/01/1993   17.35.00
  609.            Latin America          003           23/01/1993   5:35:00.00p
  610.            Netherlands            031           23-01-1993   17:35:00
  611.            Norway                 047           23.01.1993   17:35:00
  612.            Poland                 048           1993-01-23   17:35:00
  613.            Portugal               351           23-01-1993   17:35:00
  614.            Spain                  034           23/01/1993   17:35:00
  615.            Sweden                 046           1993-01-23   17.35.00
  616.            Switzerland            041           23.01.1993   17,35,00
  617.            United Kingdom         044           23/01/1993   17:35:00.00
  618.            United States          001           01-23-1993   5:35:00.00p
  619.            Yugoslavia             038           1993-01-23   17:35:00
  620.  
  621.    Character sets for the following countries or languages are  also  available
  622.    with special versions of MS-DOS:  Arabic,  Israel,  Japan,  Korea,  People's
  623.    Republic of China, and Taiwan.
  624.  
  625.  
  626.  
  627. EUMAIL.DOC                             15                          Apr 28, 1997
  628.  
  629. Author:
  630.  
  631. This program was written by Bruce Guthrie of Wayne Software.  It  is  free  for
  632. use and  redistribution  provided  relevant  documentation  is  kept  with  the
  633. program, no changes are made to the program or documentation,  and  it  is  not
  634. bundled with commercial programs or charged for separately.  People who need to
  635. bundle it in for-sale packages must  pay  a  $50  registration  fee  to  "Wayne
  636. Software" at the following address.
  637.  
  638. Additional information about this and other  Wayne  Software  programs  can  be
  639. found in the file BRUCE.DOC which should be included in the original ZIP  file.
  640. The recent change history for this and the other programs is  provided  in  the
  641. HISTORY.ymm file which should be in the same ZIP file where "y" is replaced  by
  642. the last digit of the year and "mm" is the two  digit  month  of  the  release;
  643. HISTORY.611 came out in November 1996.  This same naming convention is used  in
  644. naming the ZIP file (EUMALymm.ZIP) that this program was included in.
  645.  
  646. Comments and suggestions can also be sent to:
  647.  
  648.                 Bruce Guthrie
  649.                 Wayne Software
  650.                 113 Sheffield St.
  651.                 Silver Spring, MD 20910
  652.  
  653.                 fax: (301) 588-8986
  654.                 e-mail: bguthrie@nmaa.org
  655.                 http://www.geocities.com/SiliconValley/Lakes/2414
  656.  
  657. Please provide an Internet e-mail address on all correspondence.
  658.  
  659. 
  660.